<!DOCTYPE html>
<html lang="en" dir="ltr">
<head>
  <meta charset="utf-8" />
  <title>opencpn:opencpn_user_manual:plugins:included_plugins:dashboard</title>
<meta name="generator" content="DokuWiki"/>
<meta name="robots" content="index,follow"/>
<meta name="keywords" content="opencpn,opencpn_user_manual,plugins,included_plugins,dashboard"/>
<link rel="search" type="application/opensearchdescription+xml" href="../../lib/exe/opensearch.html" title="OpenCPN Manuals"/>
<link rel="start" href="dashboard.html"/>
<link rel="contents" href="dashboard.html" title="Sitemap"/>
<link rel="alternate" type="application/rss+xml" title="Recent Changes" />
<link rel="alternate" type="application/rss+xml" title="Current namespace" />
<link rel="alternate" type="text/html" title="Plain HTML" href="dashboard.html"/>
<link rel="alternate" type="text/plain" title="Wiki Markup" href="dashboard.html"/>
<link rel="canonical" href="http://localhost/dokuwiki/doku.php?id=opencpn:opencpn_user_manual:plugins:included_plugins:dashboard"/>
<link rel="stylesheet" type="text/css" href="../../lib/exe/css.php.t.bootstrap3.css"/>
<!--[if gte IE 9]><!-->
<script type="text/javascript">/*<![CDATA[*/var NS='opencpn:opencpn_user_manual:plugins:included_plugins';var JSINFO = {"id":"opencpn:opencpn_user_manual:plugins:included_plugins:dashboard","namespace":"opencpn:opencpn_user_manual:plugins:included_plugins","confirm_delete":"Are you sure you want to delete this page?","doku_base":"\/dokuwiki\/","cg_rev":"","dw_version":49.5,"chrome_version":0,"hide_captcha_error":"none","ckg_dbl_click":"","ckg_canonical":0,"has_wrap":"Wrap","wrapDiv":"WRAP","wrapSpan":"wrap","ckgEdPaste":"off","rel_links":0,"isadmin":0,"isauth":0,"move_renameokay":false,"schemes":["http","https","telnet","gopher","wais","ftp","ed2k","irc","ldap"],"htmlok":0};
/*!]]>*/</script>
<script type="text/javascript" charset="utf-8" src="../../lib/exe/jquery.php.t.bootstrap3.js"></script>
<script type="text/javascript" charset="utf-8" src="../../lib/exe/js.php.t.bootstrap3.js"></script>
<!--<![endif]-->

    <script type="text/javascript">
    //<![CDATA[ 
    function LoadScript( url )
    {
     document.write( '<scr' + 'ipt type="text/javascript" src="../..//url"><\/scr' + 'ipt>' ) ;        

    }
   function LoadScriptDefer( url )
    {
     document.write( '<scr' + 'ipt type="text/javascript" src="../..//url" defer><\/scr' + 'ipt>' ) ;        

    }
//]]> 

 </script>
</head>
<body>
<div class="dokuwiki export">



<h1 class="sectionedit1" id="dashboard">Dashboard</h1>
<div class="level1">

<p>
The Dashboard plugin is able to show quite a few instruments.
<strong>The Dashboard plugin is always distributed with OpenCPN, no separate download is required.</strong>
</p>

<p>
If the data is available to OpenCPN in the NMEA0183 data stream the different instruments will display relevant data; but the plugin won&#039;t tell what is available. It is assumed that the user knows what is connected. It is of course possible to activate all instruments and see what works.
</p>

</div>
<!-- EDIT1 SECTION "Dashboard" [20-492] -->
<h2 class="sectionedit2" id="the_dashboard_in_action">The Dashboard in action</h2>
<div class="level2">

<p>
There are two Dashboards, one vertical and one horizontal.
</p>

<p>
Grab the top Caption bar with the cursor and drag the Dashboard as far as possible to the right or left. Let go the cursor, and the Dashboard will dock, the chart display will adjust, no part of the chart will be hidden. Horizontal Dashboards can in a similar way be docked top or bottom.
This process is reversible. Just grab the Dashboard dialog bar with the cursor, an pull towards the middle of the screen, and the Dashboard will become floating.
</p>

<p>
<img src="../../opencpn/manual/plugins/dashboard/dashboard32.h.454_tok.963638_w.600.jpg" class="media" alt="" width="600" height="454" />
</p>

<p>
The same Dashboards docked left and bottom.
</p>

<p>
<img src="../../opencpn/manual/plugins/dashboard/dashboard-docked32.h.480_tok.2b2afc_w.600.jpg" class="media" alt="" width="600" height="480" />
</p>

<p>
There is a grab handle in the SE corner of each Dashboard. Use it to resize each dialog.
The graphics will change size, but not the text, which is handled separately. See further down.
</p>

<p>
<img src="../../opencpn/manual/plugins/dashboard/dash-drag.h.454_tok.173229_w.600.jpg" class="media" alt="" width="600" height="454" />
</p>

</div>
<!-- EDIT2 SECTION "The Dashboard in action" [493-1483] -->
<h2 class="sectionedit3" id="the_dashboard_tab">The Dashboard Tab</h2>
<div class="level2">

<p>
Once the Dashboard plugin is activated in the plugin tab, the Dashboard Icon will be available in the ToolBar and will work as an on/off toggle. The Preference button works exactly the same as described under “Dashboard Settings” below.
</p>

<p>
<img src="../../opencpn/manual/plugins/dashboard/dashboard-plugin32.h.682_tok.29c450_w.600.jpg" class="media" alt="" width="600" height="682" />
</p>

<p>
The “Enable” Button activates the plugin and shows the icon in the ToolBar.
Once enabled, the “Disable” Button is displayed, as show above.
If you press the “Preference” Button the Dashboard preferences dialog becomes available.
</p>

</div>
<!-- EDIT3 SECTION "The Dashboard Tab" [1484-2058] -->
<h3 class="sectionedit4" id="dashboard_settings">Dashboard settings</h3>
<div class="level3">

<p>
<img src="../../opencpn/manual/plugins/dashboard/dash-set.h.239_tok.f1c383_w.298.jpg" class="media" alt="" width="298" height="239" />
</p>

<p>
Right click anywhere in a Dashboard and a few options are displayed, in a small dialog.
Above we have clicked on the vertical Dashboard. Make this Dashboard horizontal by clicking the “Horizontal” radio button. Stop displaying it by un-ticking the box in front of the first “Dashboard” line. Get it back by right clicking on the other Dashboard and tick the same box again.
</p>

</div>
<!-- EDIT4 SECTION "Dashboard settings" [2059-2527] -->
<h3 class="sectionedit5" id="preferences">Preferences</h3>
<div class="level3">

<p>
<img src="../../opencpn/manual/plugins/dashboard/dashprop322.h.455_tok.779138_w.450.jpg" class="media" alt="" width="450" height="455" />
</p>

</div>
<!-- EDIT5 SECTION "Preferences" [2528-2617] -->
<h3 class="sectionedit6" id="the_dashboard_tab1">The Dashboard Tab</h3>
<div class="level3">

<p>
The Icons in the narrow pane to the left, represents the available instances. Click on an instance and the configured instruments shows in the “Instruments” pane.
</p>

<p>
<strong>“+” and “-“</strong> Add or delete a Dashboard instance. Note, that an active Dashboard can not be deleted as the ”-” will be grayed out. Configure a new instance by “Add”-ing instruments in the “Instrument” pane.
</p>

<p>
<strong>Show this Dashboard</strong> If ticked just that Dashboard is shown. Toggling the icon displays all Dashboards.
</p>

<p>
<strong>Caption</strong> changes the name of the DashBoard from the default “Dashboard” to the Caption value.
Due to a wxWidgets bug, this change is not instant, and requires docking the Dashboard or restarting OpenCPN, to work.
</p>

<p>
<strong>Orientation</strong> A dash board can be either Vertical or Horizontal.
Vertical can be docked left or right, Horizontal can be docked top or bottom.
</p>

<p>
<strong>The “Instruments” pane</strong>. Shows the Instruments that are “active”, that will show up in that particular Dashboard .The instruments are selected with the buttons to the right.
</p>

<p>
<strong>Add</strong>. This button brings up the “Add Instrument” dialog where the available instruments can be highlighted and added to the Instruments Window.
</p>

<p>
<img src="../../opencpn/manual/plugins/dashboard/dash-select-instr_0.h.265_tok.7d7a55_w.260.jpg" class="media" alt="" width="260" height="265" />
</p>

</div>
<!-- EDIT6 SECTION "The Dashboard Tab" [2618-3892] -->
<h3 class="sectionedit7" id="instruments_available">40 Instruments Available</h3>
<div class="level3">
<div class="table sectionedit8"><table class="inline">
	<tr class="row0">
		<td class="col0"> Position (text) </td>
	</tr>
	<tr class="row1">
		<td class="col0"> SOG (text) -Speed Over Ground </td>
	</tr>
	<tr class="row2">
		<td class="col0"> Speedometer (dial) </td>
	</tr>
	<tr class="row3">
		<td class="col0"> COG(text) - Course Over Ground </td>
	</tr>
	<tr class="row4">
		<td class="col0"> GPS Compass(dial) </td>
	</tr>
	<tr class="row5">
		<td class="col0"> STW(text) Speed Through Water </td>
	</tr>
	<tr class="row6">
		<td class="col0"> True HDG(text) Heading </td>
	</tr>
	<tr class="row7">
		<td class="col0"> Apparent WindAngle &amp; Speed(dial) See <a href="http://www.cruisersforum.com/forums/f134/mwv-sentences-not-working-in-dashboard-159069.html" class="urlextern" title="http://www.cruisersforum.com/forums/f134/mwv-sentences-not-working-in-dashboard-159069.html" rel="nofollow">MWV</a></td>
	</tr>
	<tr class="row8">
		<td class="col0"> App. Wind speed(text) </td>
	</tr>
	<tr class="row9">
		<td class="col0"> App. Wind speed(dial) </td>
	</tr>
	<tr class="row10">
		<td class="col0"> True Wind Angle &amp; Speed(dial) </td>
	</tr>
	<tr class="row11">
		<td class="col0"> Depth(text)<sup>1</sup> </td>
	</tr>
	<tr class="row12">
		<td class="col0"> Depth(dial)<sup>1</sup> </td>
	</tr>
	<tr class="row13">
		<td class="col0"> Water Temp(text) </td>
	</tr>
	<tr class="row14">
		<td class="col0"> VMG(text)- Velocity Made Good to a waypoint </td>
	</tr>
	<tr class="row15">
		<td class="col0"> VMG(dial) </td>
	</tr>
	<tr class="row16">
		<td class="col0"> Rudder Angle(text) </td>
	</tr>
	<tr class="row17">
		<td class="col0"> Rudder Angle(dial) </td>
	</tr>
	<tr class="row18">
		<td class="col0"> GPS in view(text)- the number of satellites detected<sup>2</sup> </td>
	</tr>
	<tr class="row19">
		<td class="col0"> GPS status(dial)<sup>2</sup> </td>
	</tr>
	<tr class="row20">
		<td class="col0"> Cursor, shows the position of the cursor. </td>
	</tr>
	<tr class="row21">
		<td class="col0"> Clock, showing UTC from the NMEA stream, in most cases this is the gps time. </td>
	</tr>
	<tr class="row22">
		<td class="col0"> Sunrise/Sunset </td>
	</tr>
	<tr class="row23">
		<td class="col0"> Moon phase </td>
	</tr>
	<tr class="row24">
		<td class="col0"> Air Temp </td>
	</tr>
	<tr class="row25">
		<td class="col0"> App. Wind angle </td>
	</tr>
	<tr class="row26">
		<td class="col0"> True Wind angle </td>
	</tr>
	<tr class="row27">
		<td class="col0"> True Wind direction </td>
	</tr>
	<tr class="row28">
		<td class="col0"> True Wind Speed </td>
	</tr>
	<tr class="row29">
		<td class="col0"> True Wind Direction and speed </td>
	</tr>
	<tr class="row30">
		<td class="col0"> Magnetic Hdg </td>
	</tr>
	<tr class="row31">
		<td class="col0"> True Compass </td>
	</tr>
	<tr class="row32">
		<td class="col0"> Wind History </td>
	</tr>
	<tr class="row33">
		<td class="col0"> Trip Log </td>
	</tr>
	<tr class="row34">
		<td class="col0"> Sum Log </td>
	</tr>
	<tr class="row35">
		<td class="col0"> Barometric Pressure (dial) </td>
	</tr>
	<tr class="row36">
		<td class="col0"> Barometric Pressure (text) </td>
	</tr>
	<tr class="row37">
		<td class="col0"> Barometric History </td>
	</tr>
	<tr class="row38">
		<td class="col0"> From Ownship. Shows the vector from Ownship to the cursor. </td>
	</tr>
	<tr class="row39">
		<td class="col0"> Magnetic COG<sup>2</sup><br/>
</td>
	</tr>
</table></div>
<!-- EDIT8 TABLE [3927-5259] -->
<p>
1. The DPT sentence is used, and transducer offset will be added to depth value, if available.<br/>

2. Linux note: GPS satellite info is not available if using gpsd.
The same informations is however available through the “xgps” command.
</p>

</div>
<!-- EDIT7 SECTION "40 Instruments Available" [3893-5495] -->
<h3 class="sectionedit9" id="delete">Delete</h3>
<div class="level3">

<p>
Highlight an entry in the Instrument Window to delete it.
</p>

</div>
<!-- EDIT9 SECTION "Delete" [5496-5569] -->
<h3 class="sectionedit10" id="updown">Up / Down</h3>
<div class="level3">

<p>
Highlight an entry in the Instrument Window and change the order between the selected instruments.  This order will also be the order between the instruments in the Dashboard dialog.
</p>

</div>
<!-- EDIT10 SECTION "Up / Down" [5570-5771] -->
<h3 class="sectionedit11" id="the_appearance_tab">The Appearance Tab</h3>
<div class="level3">

<p>
<img src="../../opencpn/manual/plugins/dashboard/dashboard-preferences-appearance.h.385_tok.a12ee0_w.443.jpeg" class="media" title="dashboard-preferences-appearance.jpg" alt="dashboard-preferences-appearance.jpg" width="443" height="385" />
</p>

<p>
Use this tab to set fonts.
</p>

</div>
<!-- EDIT11 SECTION "The Appearance Tab" [5772-5917] -->
<h3 class="sectionedit12" id="dampen_sog_and_cog_ir_filter">Dampen SOG and COG (IR Filter)</h3>
<div class="level3">

<p>
There are 2 parameters in the Dashboard→Preferences→Appearance dialog for damping of SOG and COG.
A value of 1 means no filtering. Higher values mean ever slower response of the instrument.
The max filter value is 100 which is pretty slow. This filter works almost exactly like a mechanical filter that uses an oil damped indicator dial. It will respond gradually to a change in course or speed. A typical filter value of 10 seems to work pretty well.
</p>

</div>
<!-- EDIT12 SECTION "Dampen SOG and COG (IR Filter)" [5918-6411] -->
<h3 class="sectionedit13" id="units_selection">Units Selection</h3>
<div class="level3">

<p>
Select these parameters as suits your use. These controls together enable the user to adjust the view of the dashboard to suit individual needs.
</p>

<p>
<img src="../../opencpn/manual/plugins/dashboard/dash-big-fonts.h.691_tok.9dbd07_w.700.jpg" class="media" alt="" width="700" height="691" />
</p>

<p>
<strong>Units Ranges and Formats</strong>
Set the units to use, and the range of the speed dial.
</p>

<p>
<img src="../../opencpn/manual/33speed12.h.250_tok.e4edd8_w.231.jpg" class="media" alt="" width="231" height="250" /> <img src="../../opencpn/manual/33speed50.h.250_tok.3758bc_w.231.jpg" class="media" alt="" width="231" height="250" /><br/>

</p>

</div>
<!-- EDIT13 SECTION "Units Selection" [6412-6837] -->
<h3 class="sectionedit14" id="wind_history">Wind History</h3>
<div class="level3">

<p>
The Wind History Instrument needs some further explanations.
</p>

<p>
<strong>The “wind history” instrument is meant to be run as a standalone (vertical) instrument.</strong><br/>

Just define a separate dashboard and add it as the only instrument.
</p>

<p>
<img src="../../opencpn/manual/wh2.h.421_tok.73563c_w.345.jpg" class="media" alt="" width="345" height="421" />
</p>

<p>
You can resize the Instrument with the mouse.
</p>

<p>
<img src="../../opencpn/manual/wh.h.181_tok.698a4c_w.800.jpg" class="media" alt="" width="800" height="181" />
</p>

<p>
In real conditions, it monitors around 40 min of wind direction (red), as well as wind speed (blue), showing a vertical time line every 5 min (the example screen shot is a full-speed VDR replay).
</p>

<p>
The text on the top shows the current values, as it is displayed in the standard instruments (blue = wind speed data, TWS=True Wind Speed, red = direction, TWD = True Wind Direction).
</p>

<p>
Here is an explanation of the text line, left side (see screen shot):<br/>

TWS 7.5: true Wind Speed currently 7.5 kts<br/>

Max 22.3 kts since 18:50: this is the max Wind speed in the visible graphs, i.e. the last ~40 mins<br/>

Overall 22.3: the max wind speed since OpenCPN was started.
</p>

<p>
Right side above:
TWD 357 degrees: True wind direction currently 357 degrees
</p>

<p>
The thin red/blue curves are the real direction/speed values, the thicker curves are smoothed values. Makes it easier to see trends.
</p>

<p>
There is some logic included :
The instruments zooms automatically as much as possible, always trying to show the whole visible curve;<br/>

Wind speed curve:<br/>

if your max (visible) wind speed is 10 kts, then your scale is from 0…11 kts (rounded upwards to the next full knot).<br/>

In the screen shot we had a mx of 22.3kts –&gt; scale is 0…23 kts.<br/>

Wind direction:<br/>

The instrument scale shows +/- 90 degrees of the currently visible data values, but is limited to a total of 360 degrees.<br/>

If the wind is shifting through North (from 350, 355, 359, 002, 010, …) we&#039;re shifting the curve as well, meaning that there is NO vertical jump in the data from 360 degrees –&gt; 0 degrees, and we do NOT loose all the continuity in the smoothed curves !
</p>

<p>
If you should happen to have more than a full 360 degrees cycle of wind direction in the recorded data (if you sail through a couple of dust devils ), I limited the max scale to 360 degrees, meaning that the curve will run out of the visible area on bottom or on top of the instrument.
</p>

<p>
Please note that you don&amp;#39;t have to have the instrument “open” all the time.
Once activated as initially described, you can close it, and simply reopen it on demand. You don&#039;t loose the curves, the instrument continues to collect the data.
To make it visible again simply right click on an existing standard-dashboard, and click the “Wind History” Dashboard.
</p>

<p>
<img src="../../opencpn/manual/wh1.h.134_tok.cf37cf_w.162.jpg" class="media" alt="" width="162" height="134" />
</p>

</div>
<!-- EDIT14 SECTION "Wind History" [6838-9528] -->
<h3 class="sectionedit15" id="night_time_mode">Night time Mode</h3>
<div class="level3">

<p>
In Windows, Night, F5, mode. The title bar on the floating dashboard window is a bit glaring (this mode is controlled by windows by way of a theme and is not possible to change from an application) . Dock the Dashboard into “docked mode” it will be less glaring. The best solution is to simply “dock” the dashboard window at night, either left or right. This brings the window decorations back under OCPN control, and we recently added logic to dim it in this mode.
</p>

</div>
<!-- EDIT15 SECTION "Night time Mode" [9529-10020] -->
<h3 class="sectionedit16" id="dashboard_time">Dashboard Time</h3>
<div class="level3">

<p>

</p>
<ol>
<li class="level1"><div class="li"> GPS clock - same as old Clock</div>
</li>
<li class="level1"><div class="li"> Local GPS clock - GPS clock with offset (see more below)</div>
</li>
<li class="level1"><div class="li"> Local CPU clock - Local CPU clock obtained from operating system</div>
</li>
</ol>

<p>
Local GPS clock has 2 options for time zone. On the appearance tab of the Dashboard preferences there is a new setting for “Local offset from UTC”. The default is 00:00. When the 00:00 is selected then Local GPS clock will display time in the time zone of the computer running OpenCPN. If that is not what you want then you can selected any other offset in 30 minute increments up to +/- 12 hours. That offset will be added to the GPS UTC time and the local computer time zone will be ignored.
</p>

</div>

<h4 id="sunrise_-_sunset">Sunrise - Sunset</h4>
<div class="level4">

<p>
Sunrise/sunset are computed based on the date and lat/long from the GPS NMEA input data. They are not computed from the CPU clock or the ship&#039;s position. So unless you have a GPS connected then the times of sunrise/sunset are probably not going to be right. It has always been thus. 
</p>

</div>
<!-- EDIT16 SECTION "Dashboard Time" [10021-] -->
<!-- no cachefile used, but created /var/www/html/dokuwiki/data/cache/4/4d98045c84d0522249ca075c48216f25.xhtml -->
</div>
</body>
</html>
